<releaseinfo>This manual describes version 2.12 of Search for Files.
</releaseinfo>
<legalnotice>
<title>피드백</title>
<para>To report a bug or make a suggestion regarding the Search for Files application or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>.
</para>
<!-- Translators may also add here feedback address for translations -->
</legalnotice>
</articleinfo>
<indexterm>
<primary>Search Tool</primary>
</indexterm>
<!-- ============= Document Body ============================= -->
<para>The <application>Search for Files</application> application enables you to search for files on your system. To perform a basic search, you can type a filename or a partial filename, with or without wildcards. To refine your search, you can apply additional search options.</para>
<para><application>Search for Files</application> uses the <command>find</command>, <command>grep</command>, and <command>locate</command> UNIX commands. By default, when performing a basic search <application>Search for Files</application> first uses the <command>locate</command> command, and then uses the slower but more thorough <command>find</command> command.</para>
<para>The case sensitivity of the search depends on your operating system. For example, on Linux, the <command>find</command>, <command>grep</command>, and <command>locate</command> commands support the <literal>-i</literal> option, so all searches are case-insensitive.</para>
</sect1>
<sect1 id="gsearchtool-getting-started">
<title>Getting Started</title>
<para>You can start <application>Search for Files</application> in the following ways:
</para>
<variablelist>
<varlistentry>
<term>From a <guimenu>Menu Bar</guimenu> on a panel</term>
<listitem>
<para>Choose <menuchoice><guisubmenu>Places</guisubmenu><guimenuitem>Search for Files...</guimenuitem></menuchoice></para>
</listitem>
</varlistentry>
<varlistentry>
<term>From a <guimenu>Main Menu</guimenu> on a panel</term>
<listitem>
<para>Choose <menuchoice><guimenuitem>Search for Files...</guimenuitem></menuchoice></para>
</listitem>
</varlistentry>
<varlistentry>
<term>From a command line</term>
<listitem>
<para>Execute the following command: <command>gnome-search-tool</command></para>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
<para>When you start <application>Search for Files</application>, the following window is displayed.</para>
<para>To perform a basic search for a file on the system, perform the following steps:</para>
<orderedlist>
<listitem><para>Enter the search text in the <guilabel>Name contains</guilabel> field. The search text can be a filename or partial filename, with or without wildcards, as shown in the following table:</para>
<informaltable frame="all">
<tgroup cols="3" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="33*"/>
<colspec colname="COLSPEC1" colwidth="33*"/>
<colspec colname="COLSPEC2" colwidth="34*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Name Contains Text</para></entry>
<entry colname="COLSPEC1">
<para>예제</para></entry>
<entry colname="COLSPEC2">
<para>Result</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry>
<para>Full or partial filename
</para>
</entry>
<entry>
<para><userinput>myfile.txt</userinput>
</para>
</entry>
<entry>
<para><application>Search for Files</application> searches for all files that contain the text <userinput>myfile.txt</userinput> in the filename.
</para>
</entry>
</row>
<row valign="top">
<entry>
<para>Partial filename combined with wildcards (*, [, ])
</para>
</entry>
<entry>
<para><userinput>*.[ch]</userinput>
</para>
</entry>
<entry>
<para><application>Search for Files</application> searches for all files that have extension <userinput>.c</userinput> or <userinput>.h</userinput>.
</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem><para>In the <guilabel>Look in folder</guilabel> field, select the folder or device from which you want <application>Search for Files</application> to begin the search.
</para></listitem>
<listitem><para>Click <guibutton>Find</guibutton> to perform the search. </para>
</listitem>
</orderedlist>
<para>
<application>Search for Files</application> searches in the directory that you specify and the subdirectories of the directory.
<application>Search for Files</application> displays the results of the search in the <guilabel>Search results</guilabel> list box. If <application>Search for Files</application> does not find any files that match the search criteria, the application displays the message "No files found" in the <guilabel>Search results</guilabel> list box.
</para>
<para>By default, <application>Search for Files</application> will perform a quick search using the <command>locate</command> command followed by a more thorough second search using the <command>find</command> command. The <command>locate</command> command is faster because it uses a database of information about files. If this database is more than a week old, <application>Search for Files</application> could warn you that the search results may be out of date and give you the option of disabling the quick search. To update the database, run the command <command>updatedb</command> as the root user.</para>
</sect2>
<sect2 id="gsearchtool-advanced">
<title>To Add Search Options</title>
<para>You can add additional options to search for a file on the system. To add search options, perform the following steps:</para>
<orderedlist>
<listitem><para>Click on the <guilabel>Select more options</guilabel> text. </para></listitem>
<listitem><para>Click on the <guilabel>Available options</guilabel> drop-down list.</para></listitem>
<listitem><para>Select the search option that you want to apply.</para></listitem>
<listitem><para>Specify the required search information for the search option, as described in <xref linkend="tbl-search-rules"/>.</para></listitem>
<listitem><para>Repeat the above steps for each search option that you want to apply.</para></listitem>
</orderedlist>
<para>To remove a search option from the current search, click on the <guibutton>Remove</guibutton> button next to the option. </para>
<para>To disable the search options from the current search, click on the <guilabel>Select more options</guilabel> text.</para>
<table id="tbl-search-rules" frame="topbot">
<title>Search Options</title>
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="33*"/>
<colspec colname="COLSPEC1" colwidth="33*"/>
<thead>
<row valign="top">
<entry>
<para>Option Name</para></entry>
<entry>
<para>설명</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry>
<para>Contains the text</para></entry>
<entry>
<para>Search for files of type plain text that contain the specified text.</para></entry>
</row>
<row valign="top">
<entry>
<para>Date modified less than</para></entry>
<entry>
<para>Search for files that are modified less than the period specified in days.</para></entry>
</row>
<row valign="top">
<entry>
<para>Date modified more than</para></entry>
<entry>
<para>Search for files that are modified longer than the period specified in days.</para></entry>
</row>
<row valign="top">
<entry>
<para>Size at least</para></entry>
<entry>
<para>Search for files that are equal to or larger than the size specified in kilobytes.</para></entry>
</row>
<row valign="top">
<entry>
<para>Size at most</para></entry>
<entry>
<para>Search for files that are smaller than or equal to the size specified in kilobytes.</para></entry>
</row>
<row valign="top">
<entry>
<para>File is empty</para></entry>
<entry>
<para>Search for empty files.</para></entry>
</row>
<row valign="top">
<entry>
<para>Owned by user</para></entry>
<entry>
<para>Search for files that are owned by the user specified. Type the name of the user in the text box provided.</para></entry>
</row>
<row valign="top">
<entry>
<para>Owned by group</para></entry>
<entry>
<para>Search for files that are owned by the group specified. Type the name of the group in the text box provided. </para></entry>
</row>
<row valign="top">
<entry>
<para>Owner is unrecognized</para></entry>
<entry>
<para>Search for files that are owned by a user or group that is unknown to the system.</para></entry>
</row>
<row valign="top">
<entry>
<para>Name does not contain</para></entry>
<entry>
<para>Search for filenames that do not contain the string that you enter. Enter a full filename or a partial filename with wildcards in the field provided. Use * to indicate a sequence of characters. Use ? to indicate a single character. The search is case sensitive.</para></entry>
<para>Search for files that contain the specified regular expression in their directory path or filename. Type the regular expression in the text box provided. </para></entry>
</row>
<row valign="top">
<entry>
<para>Show hidden and backup files</para></entry>
<entry>
<para>Include hidden and backup files in the search. </para></entry>
</row>
<row valign="top">
<entry>
<para>Follow symbolic links</para></entry>
<entry>
<para>Follow symbolic links when searching for files.</para></entry>
</row>
<row valign="top">
<entry>
<para>Include other filesystems</para></entry>
<entry>
<para>Search in directories that are not in the same filesystem as the start directory.</para></entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="gsearchtool-stop">
<title>To Stop a Search</title>
<para>Click <guibutton>Stop</guibutton> to stop a search before <application>Search for Files</application> completes the search. </para>
</sect2>
<sect2 id="gsearchtool-view">
<title>To Open a Displayed File</title>
<para>To open a file displayed in the <guilabel>Search results</guilabel> list box, perform one of the following steps:</para>
<itemizedlist>
<listitem><para>Right-click on the file, then choose <guimenuitem>Open</guimenuitem>. </para></listitem>
<listitem><para>Double-click on the file. </para></listitem>
</itemizedlist>
<para>To open the folder that contains a file displayed in the <guilabel>Search results</guilabel> list box, right-click on the file, then choose <guimenuitem>Open Folder</guimenuitem>.</para>
</sect2>
<sect2 id="gsearchtool-delete">
<title>To Delete a Displayed File</title>
<para>To delete a file displayed in the <guilabel>Search results</guilabel> list box, right-click on the file, then choose <guimenuitem>Move to Trash</guimenuitem>. </para>
</sect2>
<!--
<sect2 id="gsearchtool-search-command">
<title>To View the Search Command Used by &app;</title>
<para>To view the command that <application>&app;</application> used to perform the previous search, choose <menuchoice><guimenu>Search</guimenu><guimenuitem>Show Command</guimenuitem></menuchoice>. The <guilabel>Search Command Line</guilabel> displays the command. </para>
</sect2>
-->
<sect2 id="gsearchtool-savetofile">
<title>To Save the Search Results</title>
<para>To save the results of the last search that <application>Search for Files</application> performed, right-click in the <guilabel>Search results</guilabel> list, then choose <guimenuitem>Save Results As</guimenuitem>. Enter the name of the file to which you want to save the results, then click Save.</para>
<para><application>Search for Files</application> provides gconf keys to modify some of its behavior. The gconf values can be changed by starting the <application>Configuration Editor</application> in the following ways:
<para><application>Search for Files</application> speeds up file name searches by using the <command>locate</command> command. <command>Locate</command> provides a secure way to index and quickly search for file names. Because <command>locate</command> relies on a file index, the <guilabel>Search results</guilabel> list may not always be up to date.</para>
<para>After completing a quick search, <application>Search for Files</application> will perform a thorough search using the <command>find</command> command. The purpose of this second scan is to find files that have not been indexed. Files that match the search criteria are added to the <guilabel>Search results</guilabel> list keeping the list up to date.</para>
<para><application>Search for Files</application> will not perform a quick search for paths defined by this key. File name searches in the defined paths will use the <command>find</command> command. The wildcards '*' and '?' are supported.</para>
</sect2>
<sect2 id="gsearchtool-secondscanexclude">
<title>Quick Search Second Scan Excluded Paths</title>
<para><application>Search for Files</application> will not perform a second scan after a quick search for the paths defined by this key. Quick searches in the defined paths will not be followed by a thorough search using the <command>find</command> command. The wildcards '*' and '?' are supported.</para>
<para>This key determines if the <guilabel>Select more options</guilabel> section is expanded when <application>Search for Files</application> is started.</para>